Inside Macintosh: QuickDraw GX Objects /

Chapter 6 - Transform Objects / Transform Objects Reference

Functions / Getting and Setting the View Port List

GXSetShapeViewPorts

You can use the GXSetShapeViewPorts function to assign a view port list to the transform object associated with a particular shape.

void GXSetShapeViewPorts(gxShape target, long count,
                        const gxViewPort list[]);

target

A reference to the shape object whose transform's view port list you want to replace.

count

The number of view port references in the new view port list; the size of the list array.

list

The new view port list; an array of references to the view ports you want to associate with the source shape's transform.

DESCRIPTION

The GXSetShapeViewPorts function replaces the view port list of the transform object associated with the shape referenced by the target parameter with the view port list specified by the list parameter. The count parameter specifies the number of view ports in the new list.

If the source shape shares its transform object with other shapes, this function first copies the transform, associates the copy with the source shape, and then makes changes to the copy.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
shape_is_nil
invalid_viewPort_reference
parameter_out_of_range	(debugging version)
Notices (debugging version)
transform_viewPorts_already_set

SEE ALSO

To retrieve the view port list from the transform object associated with a specified shape, use the GXGetShapeViewPorts function, described in the previous section.

To assign a view port list directly to a transform object, use the GXSetTransformViewPorts function, described on page 6-74.